home *** CD-ROM | disk | FTP | other *** search
/ Cobra Utilities for Doom & Doom II / Cobra Utilities For Doom & Doom II - Disc 2.iso / files / program / dfe131 / univbe.doc < prev    next >
Encoding:
Text File  |  1993-10-22  |  9.9 KB  |  246 lines
  1.  
  2.                          The Universal VESA VBE
  3.                          ----------------------
  4.  
  5.                    Copyright (C) 1993 SciTech Software
  6.                            All rights reserved.
  7.  
  8. What is it?
  9. -----------
  10.  
  11. The Universal VESA VBE is a small Terminate and Stay Resident (TSR) program
  12. that extends the video BIOS of SuperVGA video cards to make them compatible
  13. with the Video Electonics Standards Association (VESA) recommended
  14. Video BIOS Extensions (VBE).
  15.  
  16. By having a video card that has a VESA VBE compatible BIOS, or by
  17. installing this small TSR, programs that support the VESA VBE programming
  18. interface will work correctly for your SuperVGA. This helps to solve a
  19. lot of problems with compatability between different SuperVGA cards on the
  20. market. Note that this program will not take advantage of any of the
  21. acceleration features that your video card may provide.
  22.  
  23. Why use it?
  24. -----------
  25.  
  26. You may already have a VESA VBE TSR for you video card, or you video card
  27. may have a VESA VBE compatible BIOS already, so why would you want to use
  28. this program?
  29.  
  30. The simple answer is that most of the TSR's that exist today, and a lot
  31. of the not-so-new SuperVGA cards that are around implement an older version
  32. of the VESA VBE programming interface (if any at all). For this reason, some
  33. programs that use the advanced features of the new VESA VBE standard will
  34. not work with the TSR or BIOS that you currently have.
  35.  
  36. So what advanced features does this TSR provide that other's don't? The
  37. Universal VESA VBE implements the VESA VBE 1.2 programming interface,
  38. which supports the following features:
  39.  
  40.     . SuperVGA page flipping. High performance animation programs can
  41.       use your card to full potential using the VESA BIOS to implement
  42.       extended page flipping (imagine, 1024x768x16 double buffered
  43.       animation, or even 800x600x256 and 640x400x32k/64k on a 1Mb video
  44.       card!!).
  45.  
  46.     . SuperVGA virtual screens. Programs may set up a virtual display
  47.       resolution of say 1024x1024 pixels, and smoothly scroll a window
  48.       with less physical resolution around within this buffer.
  49.  
  50.     . Support for the 32k, 64k and 16 million color video modes. As well
  51.       as supporting the industry standard 16 and 256 color video
  52.       modes.
  53.  
  54.     . Speed. The bank switching code in this package tends to run faster
  55.       than the routines embedded in the VIDEO BIOS of some video cards.
  56.  
  57.     . Programs that know about the Universal VESA VBE protected mode
  58.       extensions can use the high performance protected mode programming
  59.       interface provided by this TSR.
  60.  
  61.     . Extremely small size. When the TSR is resident in your computer it
  62.       only requires about 3k of memory which is smaller than the
  63.       size of most commerical VESA VBE TSR's. It may also be loaded high
  64.       to save even more memory.
  65.  
  66. Hardware Requirements
  67. ---------------------
  68.  
  69. The Universal VESA VBE will run on any 80x86 based IBM PC compatible
  70. running MSDOS. Currently the Universal VESA VBE supports the following
  71. SuperVGA cards (note that not all of these have been fully tested):
  72.  
  73.     - ATI Technologies 18800, 28800
  74.     - Ahead A & B
  75.     - Chips & Technologies 82c451/452/453
  76.     - Everex
  77.     - Genoa Systems GVGA
  78.     - OAK Technologies OTI-037C, OTI-067, OTI-077, OTI-087
  79.     - Paradise PVGA1A, WD90C00/10/11/20/21/30/31
  80.     - NCR 77C20/21/22E
  81.     - Trident 88/8900
  82.     - Video7 V7VGA versions 1-5
  83.     - Tseng Labs ET3000, ET4000, ET4000/W32
  84.     - AcuMos AVGA2
  85.     - S3 86c911/924/801/805/928
  86.     - Advance Logic AL2101 SuperVGA
  87.     - MXIC 86010 SuperVGA
  88.     - Primus 2000 SuperVGA
  89.     - RealTek 3106 SuperVGA
  90.     - Cirrus Logic CL-GD 5420, 5422, 5424, 5426, 5428
  91.  
  92. How do I install it?
  93. --------------------
  94.  
  95. You can install the TSR from the command line, or from your autoexec.bat
  96. file. Don't worry about installing it twice, it will automatically detect
  97. if you have already installed it.
  98.  
  99. To install it simply type:
  100.  
  101.     univbe
  102.  
  103. from the command line. It will determine what type of SuperVGA card you
  104. have installed and install itself accordingly. If you wish to remove the
  105. TSR from memory after it has been installed, simply type:
  106.  
  107.     univbe -u
  108.  
  109. This will remove the program from memory, even if it was not the last
  110. TSR to be installed. However if you installed another TSR after this
  111. one that has hooked into the Int 10h interface the old TSR will cease
  112. to function.
  113.  
  114. You may also use command line options to modify the the installation
  115. process used by the program. The following is produced by typing
  116. 'univesa -h' at the command line:
  117.  
  118. Options are:
  119.     -s<name> - Force detection of SuperVGA 'name'
  120.     -c<x>    - Force detection of SuperVGA chipset (numerical id)
  121.     -m<size> - Force memory size to 'size'
  122.     -d<x>    - Force DAC type (0:VGA, 1:15 bit, 2:16 bit, 3:24 bit)
  123.     -i       - Do not perform SuperVGA detection
  124.     -q       - Quiet mode
  125.     -g       - Regenerate default .ini file
  126.     -u       - Unload the Universal VESA VBE from memory
  127.     -t       - Don't go TSR, just return the detected SuperVGA id
  128.     -b       - Swap the RED and BLUE bytes in 24 bit modes.
  129.  
  130. It is possible the SuperVGA detection code will hang the machine on old
  131. VGA/SVGA cards. You can optionally force the program to work with any
  132. combination of card, chipset, memory size and DAC, but unless you specify
  133. the -i option, unspecified values will be filled in automatically for you.
  134.  
  135. Thus you if the detection code did not correctly identify you video card
  136. configuration, you can force the TSR to work with the correct values.
  137.  
  138. For some SuperVGA cards, I have not been able to work out a solid method
  139. of detecting the amount of video memory on board. If this is the case,
  140. the Universal VESA VBE will refuse to install itself and ask that you
  141. specify the amount of video memory on your card from the command line.
  142.  
  143. The Universal VESA VBE does not provide support for any of the extended
  144. text modes that your video card may provide, but will provide support
  145. for any extended text modes supported by an underlying VESA VBE compliant
  146. BIOS. Thus if you video card already has a VBE BIOS or you install
  147. your favorite VESA VBE TSR for your video card _before_ installing the
  148. Universal VESA VBE, the Universal VESA VBE will use a pass-through
  149. mechanism to ensure the extended text modes still work correctly.
  150.  
  151. What's the .ini file for?
  152. -------------------------
  153.  
  154. For most installations, the Universal VESA VBE will automatically
  155. determine the video modes that you card supports. However on some older
  156. video cards some video modes that the Universal VESA VBE thinks are
  157. available aren't and so an error will occur if a program tries to set
  158. the video mode. The .ini file is used to remove support for those video
  159. modes. You can edit the .ini file yourself or you can get the TSR
  160. to automatically generate the default .ini file for you.
  161.  
  162. In order to generate the default .ini file for you, you must remove the
  163. TSR from memory, delete the old .ini file, re-install the TSR in memory
  164. and run the program with the -g option. The default .ini file is now
  165. generated. You should then remove the TSR again and re-install it using
  166. the values in the new .ini file. A batch file called 'makeini.bat'
  167. is provided which will do this for you.
  168.  
  169. The format of the .ini file is simple. All the video modes removed by
  170. the program are listed under the section '[remove]' in the .ini file.
  171. They are listed as the hexadecimal internal mode numbers used by the
  172. TSR (see the next section for a list of the mode numbers used). An
  173. example .ini file might be:
  174.  
  175. [remove]
  176.  
  177. 10D
  178.  
  179. Video modes supported by this TSR
  180. ---------------------------------
  181.  
  182. The Universal VESA VBE supports the VESA VBE 1.2 programming interface,
  183. which defines a number of standard video modes numbers. The new version
  184. of the VESA VBE specs will allow the vendor to extend the video numbers
  185. used to whatever values they wish, so I have taken the liberty to
  186. extend the mode numbers used by the Universal VESA VBE to include
  187. modes not originally specified in the VBE 1.2 specs, but supported by
  188. a number of popular video cards on the market. Depending on how well
  189. your applications have been written, they may or may not be able to
  190. use those modes.
  191.  
  192. The following is a list of the internal mode numbers used by the Universal
  193. VESA VBE and a description of each video mode:
  194.  
  195.     102   - 800x600 16 color
  196.     104   - 1024x768 16 color
  197.     106   - 1280x1024 16 color
  198.     11C   - 640x350 256 color
  199.     100   - 640x400 256 color
  200.     101   - 640x480 256 color
  201.     103   - 800x600 256 color
  202.     105   - 1024x768 256 color
  203.     107   - 1280x1024 256 color
  204.     10D   - 320x200 32k color
  205.     11D   - 640x350 32k color
  206.     11E   - 640x400 32k color
  207.     110   - 640x480 32k color
  208.     113   - 800x600 32k color
  209.     116   - 1024x768 32k color
  210.     119   - 1280x1024 32k color
  211.     10E   - 320x200 64k color
  212.     11F   - 640x350 64k color
  213.     120   - 640x400 64k color
  214.     111   - 640x480 64k color
  215.     114   - 800x600 64k color
  216.     117   - 1024x768 64k color
  217.     11A   - 1280x1024 64k color
  218.     10F   - 320x200 16m color
  219.     121   - 640x350 16m color
  220.     122   - 640x400 16m color
  221.     112   - 640x480 16m color
  222.     115   - 800x600 16m color
  223.     118   - 1024x768 16m color
  224.     11B   - 1280x1024 16m color
  225.  
  226. Problems and known bugs
  227. -----------------------
  228.  
  229. The Universal VESA TSR seems to have problems with QEMM, since QEMM does
  230. something weird with the Video BIOS. In order to fix this problem,
  231. you should use the QEMM 'exclude' options to exclude the Video BIOS
  232. area. Do this by including the following in the QEMM options:
  233.  
  234.         EXCLUDE=C000-C1FF
  235.  
  236. Refer to the BUGS file for a list of known problems with the Universal
  237. VESA VBE.
  238.  
  239. Can I get the source code?
  240. --------------------------
  241.  
  242. Yes, you can order the full source code for the product from SciTech
  243. Software. Refer to the files PRODUCTS.DOC and ORDER.DOC for more
  244. information.
  245.  
  246.